5.2.1 MINPAY 지갑에 출금 주문 생성
#간략한 설명: 지갑의 출금 비즈니스 인터페이스로 RMB 또는 디지털 화폐를 출금하여 사용자가 지정된 지갑 주소로 계좌 잔액을 이체할 수 있도록 합니다.
- 요청방법 : POST
- 요청 인터페이스: https://gateway-domain/wallet-trade-merchant/v1/pay/wallet/create
- 요청 미디어 유형(JSON 데이터 형식)Content-Type: application/json
요청 매개변수
| 매개변수 이름 | 유형 | 필수 | 매개변수 의미 | 매개변수 설명 |
|---|---|---|---|---|
key | string | 예 | 판매자 키 | API키 |
localOrderId | string | 예 | 판매자 플랫폼 현지 주문 번호 | 판매자 플랫폼은 로컬에서 고유한 주문 번호를 생성합니다 |
localUserId | string | 아니요 | 판매자 플랫폼 로컬 사용자 ID | 판매자 플랫폼 로컬 사용자 ID |
amount | number | 예 | 주문금액 | 출금금액 |
email | string | 아니요 | 출금 이메일 주소 | 사용자 이메일 주소(사용자 ID2로 1개 선택) |
userId | string | 아니요 | 사용자 ID | 사용자 이메일(사용자 ID2로 1개 선택) |
notifyUrl | string | 아니요 | 콜백 주소 | 주문이 성공적으로 완료되면 API 콜백을 통해 가맹점 주소가 통보됩니다. (콜백 내용은 문서 3 참조) |
currency | string | 예 | 지원되는 통화 | 통화(지갑 지원 통화) |
successRedirectUrl | string | 아니요 | 주소 | 성공 후 해당 주소로 자동 점프 |
expireSecond | Long | 아니요 | 만료 타임스탬프(초) | |
sign | string | 예 | 서명 | 자세한 내용은 서명 알고리즘을 참조하세요. |
json 샘플 요청
{
"key": "08SaKUwNafSOc8w7",
"localOrderId": "2023102400684344447",
"localUserId": "302199873005",
"email": "diamond8888@gmail.com",
"amount": "100",
"currency": "CNY",
"successRedirectUrl": "WWW.BAIDU.COM",
"notifyUrl": "www.baidu.com/notify/callback",
"sign": "41c48ea2951934626b4435f02aecf732"
}
응답 JSON 예시
{
"code": 0,
"success": true,
"message": "string",
"data": {
"orderId": "2023102400684344447",
"localOrderId": "2023102400684344447",
"localUserId": "302199873005",
"withdrawBizType": "WITHDRAW_WALLET",
"orderType": "PAYMENT",
"toUserId": 4603
}
}
응답 데이터 매개변수 설명
| 매개변수 이름 | 유형 | 매개변수 의미 | 비고 |
|---|---|---|---|
orderId | string | 주문번호 | |
localUserId | string | 판매자 로컬 사용자 ID | |
localOrderId | string | 판매자 지역 주문 번호 | |
orderType | enum | 주문 유형 | PAYMENT：支付订单WITHDRAW：提款订单 |
orderBizType | enum | 주문업종 | orderBizType 유형 설명은 다음과 같습니다. |
toUserId | number | 결제사용자ID | MINPAY 지갑 사용자 ID |
orderBizType 유형 설명:
- PAYMENT_WALLET_SCAN MINPAY 지갑 스캔코드 결제
- PAYMENT_TRANSFER 디지털 화폐 바인딩 주소 직접 입금
- PAYMENT_ANY_DIGITAL_SCAN QR 코드를 스캔하여 원하는 금액의 디지털 화폐를 결제하세요.
- WITHDRAW_WALLET MINPAY 지갑으로 돈을 인출하세요.
- WITHDRAW_ANY_DIGITAL_WALLET 디지털 통화를 지갑으로 인출하세요.
- PAYMENT_FIXED_DIGITAL_SCAN 디지털화폐 한도금액 스캔코드 결제
- BATCH_PAY 일괄결제
콜백은 json 데이터를 반환합니다
기본적으로 모든 콜백 매개변수는 서명 확인에 참여합니다. 콜백 매개변수에 대한 자세한 내용은 콜백 ]를 참조하세요.
콜백 데이터
{
"amount":"4",
"bizType":"WITHDRAW_WALLET",
"currency":"USDT",
"localOrderId":"conan41123",
"merchantActualAmount":"31.45",
"merchantCurrency":"USDT",
"merchantId":302992856974,
"merchantPaidAmount":"4",
"merchantUserId":"conan",
"notifyTime":1772364467800,
"orderCreateTime":1772364292167,
"orderId":"474083263103237",
"status":"SUCCESS",
"type":"WITHDRAW",
"userAmount":"28.37",
"userCurrency":"USDT",
"userReceivableAmount":"28.37",
"walletUserId":4603,
"sign":"bc92191367449df36920178e05731a6b",
"key":"9yUreYgTRtit39Dy"
}
콜백 알림을 받으면 처리가 완료된 후 메시지가 성공적으로 수신 및 처리되었음을 나타내는 성공 문자열을 직접 반환해 주세요. 시스템이 성공 응답을 받은 후에는 더 이상 콜백을 반복적으로 보내지 않습니다. 예상된 응답을 받지 못한 경우(성공이 반환되지 않거나 예외가 반환됨) 시스템은 단계적 재시도 메커니즘에 따라 최대 14회 재시도하여 콜백 알림을 다시 보냅니다. 현재 재시도 간격은 다음과 같습니다. 15대, 15대, 30대, 180년대, 600년대, 1200년대, 1800년대, 1800년대, 1800년대, 3600년대, 10800년대, 10800년대, 21600년대, 21600년대